Color
Background
备注

三债传导链

意图债认知债技术债Why 丢失Reasoning 瓦解How 腐烂——三债交织成 System Health 的衰退链。
意图债 → 认知债

Why 消失

当系统的初衷与约束没被记录,团队只能靠观察代码"猜谜"。
  • 文档债务:架构决策散落在 PR / Slack / 个人记忆里
  • 共同理解的蒸发速度 > 补充速度
  • 无法识别原始约束 → 不敢做大胆假设
  • 心理模型碎片化,Reasoning 链中断
认知债 → 技术债

Reasoning 瓦解

想不通就不敢改,不敢改就只能乱写——补丁式编程把认知风险固化进代码。
  • 复杂函数无人重构,外面再包一层 if-else
  • 复制粘贴 + 微调,重复与耦合扩散
  • 为规避风险做的折中 → 沉淀为代码混乱
  • "想不通 → 不敢改 → 乱写" 循环成型
技术债 → 恶性循环

How 腐烂

凌乱代码反过来掩盖业务意图、放大认知负荷,三债互相滋养。
  • 掩盖意图:真实 Why 更难被识别
  • 认知负荷呈指数级上升
  • 系统健康(System Health)持续被削弱
  • "删掉它,半个城市的订单就挂了"
AI 加速器效应

生成快 · 丢得快 · 乱得快

Copilot / Cursor 写 How 飞快,但 Why 流失更快、认知债爆发更猛、没人敢系统性重构。

🎯
架构师的最高杠杆点

先补意图,再降认知,最后才动代码

ADR 记录 Why · 验收标准即文档 · 普适语言 · 共享心理模型 · 嵌入团队日常活动。

基于 Margaret-Anne Storey 的 System Health 框架 · Why 如何丢失、Reasoning 如何瓦解、How 如何腐烂